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Preface 
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help you install and administer Domino R5 using the Windows Administrator 
Client, the WebMail Client, and existing R4 clients. The new WebMail Client, 
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new WebMail Client well worth reading. 



The team that wrote this redbook 

This redbook was produced by a team of specialists from around the world 
working at the International Technical Support Organization, Austin Center. 

Jose Carlos Faisca is an OS/2 Certified Engineer in Tore Jakobson Lda., 
Portugal and has worked with OS/2 since 1988. He has extensive practical 
experience with not only Lotus Domino severs, but also OS/2 Warp Server, 
Workspace On-Demand, and OS/2 Warp Server for e-business. Jose is an IT 
consultant and Internet specialist using Lotus Domino technology. His areas 
of expertise include systems integration and Network Computing. 

Anssi Nummi was formerly an Advisory IT Specialist with IBM Finland. He 
has more than six years of experience in the computing field. He has worked 
with IBM for three and a half years. His areas of expertise include network 
operating systems, Lotus Domino/Notes, IBM Netfinity servers, and clustering 
technologies. He holds certifications in Microsoft Certified Systems Engineer 
+ Internet (MCSE+I), Certified Lotus Professional (CLP), IBM Professional 
Server Expert (PSE), OS/2 Warp 3 Certified Systems Engineer, Warp 4 
Certified Systems Expert, and Warp Server Certified Systems Expert and 
Certified Administrator. 

Tsutomu Oya is an Advisory IT Specialist at the International Technical 
Support Organization, Austin Center. He used to work with OS/2-related 
products, the OS/2 Warp Server family, and Workspace On-Demand. 
Recently, he has been working in the Java technology area. Before joining the 
ITSO, he worked in the Personal Software Product division, Technical 
Support in IBM Japan for four years. He primarily worked for CritSit support 



©Copyright IBM Corp. 1999 



XV 




for OS/2 customers. He has provided support for many OS/2 products, from 
OS/2 V2 to Warp Server V 4. He is a certified OS/2 Engineer and IBM LAN 
Server Engineer. 

A very special thank you to Dana Gordon, IBM e-business End-to-End 
Solutions, Austin, TX, and Uwe Zimmermann, IBM NCSD External 
Performance, Austin, TX for all their ideas, expertise, and contributions to this 
redbook. Although they were not members of the redbook project team, they 
contributed a lot of work and effort in making this redbook more 
customer-oriented. 



Acknowledgments 

The authors wish to thank the following people for their invaluable 
contributions to this project: 

IBM Corporation 

http : / /www . ibm . com 

• Girish Basavalingaiah, Software Analyst, India 

• Barry Bryan, IHV Support, Austin, TX 

• Charles (Chuck) Dumont, Domino for OS/2 Development, Austin, TX 

• Sam Emrick, NCSD External Performance, Austin, TX 

• Bob Gonzalez, System Integration Test, Austin, TX 

• Marion Hawker, IBM Lotus Integration Center (ILIC), Dallas, TX 

• Boyd Jasperson, NCSD System Performance, Austin, TX 

• Leon van der Linde, l/T Specialist, South Africa 

• Jan Love, e-business Integration Test, Austin, TX 

• Peter Marfatia, Technical Support, Australia 

• Daniel (Dan) Mendrala, Domino for OS/2 Test, Austin, TX 

• Beverley Michalk, OS/2 Warp Server Support, Austin, TX 

• Skip Nizinski, Netscape for OS/2 Development, Austin, TX 

• Jim Opre, formerly with IBM Austin, TX 

• Jim Roney, Customer Environment Test, Austin, TX 

• Phillip Salazar, System Integration Test, Austin, TX 

• Kim Shepard, Domino for OS/2 Development, Austin, TX 

• Paul Stephens, e-business End-to-End Solutions, Austin, TX 



xvi 



Lotus Domino R5 on OS/2 Platform 




• Mark VanderWiele, Print Devices, Austin, TX 

International Technical Support Organization (ITSO) 

http : / /www . redbooks .ibm.com 

• Indran Naick, ITSO Austin 

• Steve Russel, ITSO Raleigh 

Lotus Corporation, an IBM subsidiary 

http : / /www . lotus . com 

• Charlie Brown 

• Diane Loomis 

IRIS Associates Incorporated 

http : / /www . iris . com 

• Becky Gibson 

• James Grigsby 

Zevener Volksbank eG, Germany 

http : / /www . zvb . genonord . de / 

• Frank Mueller 



Comments welcome 

Your comments are important to us! 

We want our Redbooks to be as helpful as possible. Please send us your 
comments about this or other Redbooks in one of the following ways: 

• Fax the evaluation form found in “IBM Redbooks evaluation” on page 341 
to the fax number shown on the form. 

• Use the online evaluation form found at http://www.redbooks.ibm.com/ 

• Send your comments in an Internet note to redbook@us.ibm.com 



xvii 



XViii Lotus Domino R5 on OS/2 Platform 




Chapter 1. Introduction 



Throughout this document, two releases of Domino R5 are discussed: 

• Domino R5.0.1a 

This release, which is certified for OS/2 Warp Server V4, is the first 
Domino R5 server release on OS/2 and became available in August 1999. 
Installed on OS/2 Warp Server V4, up to 1800 clients for each server were 
tested successfully. 

• Domino R5.0.2 

This release is certified for OS/2 Warp Server for e-business with an 
general availability date of November 1999. 

This new version supports databases greater than 2 GB on OS/2 Warp 
Server for e-business and facilitates the creation of databases up to 64 
GB. It utilizes memory above 512 MB (High Memory) to improve server 
capacity, which results in up to 2045 clients per server. 

The more clients, the more powerful the system must be 

Powerful servers are required to support a high number of clients. In 
general, the more clients a server must serve, the more powerful the server 
system must be. Performance-wise, it pays to invest in fast SMP machines. 



In this document, Domino R5 always refers to both releases. 

Lotus Domino R5 for OS/2 provides Domino server functions for an OS/2 
environment. As with Domino R5 servers on other platforms, Domino R5 for 
OS/2 provides Internet-aware functions, better performance, and support for 
a large number of users. 

However, an OS/2 Notes R5 Client, equivalent to a Notes R5 Client for 
Windows, will not be released. There are several reasons for this. First, even 
if you are using Notes R4.x workstation, you never lose any functionality of 
Notes R4.x Client, and you can even get performance benefits from Domino 
R5 server for OS/2. Basically, Notes R4.x Clients work with Domino R5 for 
OS/2 perfectly well when not using R5 templates. Second, the trend of IT 
technology is moving toward thin client computing, or, in other words, an 
e-business application model. This means the browser client (thin client) has 
more focus than the Notes workstation client (fat client). 

As long as a Notes R4.x Client accesses mail or databases on a Domino R5 
server that has a R4.x compatible template, the Notes R4.x Client works fine 
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with R4 mail and database files and can even gain performance benefits from 
the newly updated On Disk Structure (ODS). For more information on the 
Domino R5 new database or storage format, refer to 5.3.5, “On Disk Structure 
41” on page 158. 

Accessing the Domino R5 server for OS/2 from the Internet using the new 
WebMail client is enhanced over the previous Domino R4.6 browser client. 
The WebMail client takes advantage of R5’s new features and performance 
improvements. However, its usage still has few restrictions. For example, 
without Domino Runtime Services (DRS) the WebMail client cannot have a 
local copy of the database and, therefore, increases network traffic. 

Lotus has announced Domino Runtime Services (DRS), which is meant to 
enhance the Notes browser client to support more administrative functions, 
mail functions, and local database and application replicas. This dramatically 
increases laptop usage. The target date for the OS/2 implementation of DRS 
is the second quarter of 2000. DRS may be a successor of Notes R4.x for 
those who want to have a thin version of Notes Client and will enhance the 
current Web browser client functionality. 



1.1 Domino R5 administration 

Many of the administrative tasks can be performed by using a Web browser 
and Notes R4 Administration as described in Chapter 7, “Administering the 
OS/2 Domino R5 server: Part 1” on page 223 and Chapter 8, “Administering 
the OS/2 Domino R5 server: Part 2” on page 253. 

A Notes R4 Client provides limited administration functions for Domino R5 
server management. Obviously, you need to have an administrator ID, such 
as the administration user.id of the server. 

Alternatively, administrative tasks can be performed using the Web browser 
interface, or they can install the Domino R5 Administrator client for Windows. 
To administrate Domino R5’s new features, a Domino R5 Administrator for 
Windows client is mandatory (for example, LDAP administration or R5 new 
user registrations). 

As mentioned previously, R5.0.1a is the first release of Domino R5 for OS/2. 
This version is certified to run on OS/2 Warp Server V4 (Entry, Advanced, 
and SMP). The certified version for OS/2 Warp Server for e-business is 
Domino R5.0.2. 
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1.2 Licenses 

Domino R5 for OS/2 is available with the following licenses: 

• Domino Application Server 

The Domino Application Server is for customers who want to use Domino 
for collaborative intranet and Internet applications in addition to mail. Also 
included is the new TeamRoom template, a powerful tool that helps 
customers quickly create applications for information sharing and 
collaboration, and Domino Enterprise Connection Services, for easy, 
non-programmatic access to backend datasources such as relational 
databases. The Domino Application Server supports systems with up to 
four CPUs. The Domino Application Server license also includes the new 
Lotus QuickPlace and IBM WebSphere. 

• Domino Mail Server 

The Domino Mail Server is for customers who want the industry-leading 
solution that offers messaging, group calendaring and scheduling, 
document libraries, and discussion databases. The Domino Mail Server 
supports systems with up to four CPUs and is the perfect solution for 
customers who want to get started quickly with a robust, easy to use and 
manage messaging solution. 

• Domino Enterprise Server 

The Domino Enterprise Server builds on the functionality of the Domino 
Mail and Application Servers and is targeted at customers needing 
unmatched performance and 24x7 (24 hours a day, 7 days a week) levels 
of reliability for messaging or collaborative applications. The Domino 
Enterprise Server supports systems beyond four CPUs to take advantage 
of increased platform horsepower. Clustering services for failover and load 
balancing for both Notes Clients and Web browsers are included with the 
Domino Enterprise Server. Customers who choose the Domino Enterprise 
Server may install more than one Domino server on a single physical 
machine using the partitioning technique, thereby leveraging the power of 
their symmetrical multiprocessing server systems. 



1.3 Domino R5: New features 

With Release 5, Domino brings Internet integration to a new level. For 
example, there is now native support for MIME and SMTP standards. 
Domino’s own Web engine has also been enhanced. In the past few years, we 
have seen that the Web has become more and more important as a 
communication channel in both business and consumer settings. As a result, 
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in some applications, interruptions in service are unacceptable. To minimize 
these, Domino R5 supports Web clients in clustered environments, making 
high availability and workload balancing a reality. 

These features and many others make Domino an even more attractive 
solution for many customer applications. 



1.4 New features in the Domino R5 server 

Table 1 highlights the most significant new features found in the R5 Domino 
server and gives a brief explanation for each of them. 

Note 

Some of the features introduced here are not enabled by default, or require 
the use of Domino Administrator R5 for Windows. 



Table 1. New features in the Domino R5 server 



New feature 


Function 


Internet mail 


Native Internet 
addressing 


Domino server currently recognizes and fully supports 
Internet addressing rules. This allows consistent user 
naming for both Notes and Internet users. This also means 
that there is no need for address conversions, which, in turn, 
improves mail routing functions. 


Native MIME support 


MIME is the message format used for Internet mail to 
support content other than plain text. Notes mail now 
supports MIME directly, which means no conversion is 
required when interchanging mail across the Internet. Notes 
also supports S/MIME, the secure version of MIME. 


Native SMTP routing 


Native Simple Mail Transfer Protocol (SMTP) routing means 
that every Domino server in your enterprise is capable of 
Internet mail routing without any add-on Mail Transfer Agent 
(MTA) tasks. This both simplifies configuration and improves 
mail routing performance since there is no conversion 
overhead. 


Security 


Fully integrated X.509 
certificates 


Domino allows administrators to register new users with 
traditional Notes certificates or with X.509 v3 certificates. 


Stronger cryptography 


Domino now supports stronger RSA keys and RC2 keys for 
North America. 
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New feature 


Function 


Common Data Security 
Architecture (CDSA) 


CDSA enables application developers to add security 
features to Domino applications. 


S/MIME 


Support for secure Internet mail delivery using encryption 
and digital signatures. 


SSL v3 


Support for SSL protocol for clients using LDAP or MOP. 


Forgotten password 
recovery 


Domino R5 introduces recovery agents that log both 
password and ID changes, enabling easy password and ID 
file recovery. 


APIs for customizing 
authentication 


New Domino Web server APIs for Web application 
developers. 


Authentication through 
third-party directory 


Enables authentication using third-party LDAP server. 


Password quality 
testing 


Administrators can define rules governing password 
construction, such as the minimum password length, case 
sensitivity requirements, and use of both numeric and 
alphabetical characters in the password. This can greatly 
improve password security in your enterprise. 


Directories 


Domino Directory 


Domino Directory is equivalent to the Public Address Book 
in earlier releases of Domino. 


Directory Catalog 


This catalog is a highly compressed and scalable 
concatenation of the Domino Directories in the enterprise. 


Directory Assistant 


Directory Assistant is equivalent to the Master Address 
Book. 


LDAP v3 


Domino now supports both LDAP v2 and v3. LDAP is an 
open standard which Lotus uses to allow Domino server to 
act as a centralized directory server for any LDAP-enabled 
client. 


Messaging 


Message tracking and 
monitoring 


This allows you to track mail messages using sender, 
recipient, date, message subject, and/or message size. The 
information that passes the defined filter is collected and 
placed in the MailTracker Store database on each mail 
server. 


Message store 
management 


Administrator now has better tools to control the disk space 
used per user. 
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New feature 


Function 


Routing control 
management 


There are several improvements over the previous release of 
Domino to better control mail routing and junk e-mail. The 
new features enable you to allow or disallow mail from 
defined domains, set the maximum message size, set the 
message priority, and set other filters for unwanted mail. 


Upgrade tools 


Domino server provides built-in tools to easily upgrade from: 

• cc:Mail 

• MS Mail 

• Windows NT and MS Exchange 

These allow the administrator in your enterprise to migrate 
your users to Domino R5 using the existing user directory, 
thus avoiding the laborious process of re-entering the user 
information. 


Message reporting 


Gives you detailed information on mail statistics, routing 
changes, and mail performance. 


Web application server 


Enhanced HTTP stack 


The Domino HTTP engine has been improved, both in 
performance and support for Java. 


Support for Internet 
Information Server 


You now have the choice to either use Domino’s native HTTP 
engine or Microsoft’s Internet Information Server (IIS) for 
Web client connectivity. 


Access control for 
HTML files 


ACLs are extended to HTML files as well. 


API for customizing 
authentication 


New API functions for application developers. 


Internet Cluster 
Manager (ICM) 


Web clients can now benefit from robust Domino clustering 
and high availability features. The ICM is a new layer to 
handle browser client requests to the Domino databases. 
The ICM forwards requests to the least busy server in the 
cluster. This and other aspects of Domino clustering are 
discussed in the book Netfinity and Domino R5.0 
Integration Guide, SG24-5313. 


Browser capabilities 


Formula language allows interrogation of the user’s browser 
capabilities, such as support for JavaScript, so that 
applications can tailor their operation to the specific browser 
being used. 
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New feature 


Function 


Live access to relational 
databases 


Support for real-time access to several relational databases. 
This enables application developers to use Domino as 
middleware between the client and back-end information 
storage. 


Virtual server logging 


Gives better analysis tools for multi-homed Web servers. You 
can also define how long the log file is used: a day, a week, 
or a month. 


Virtual server SSL 
support 


Support for multi-homed secure Web sites on one Domino 
server. 


Web server extension 
API 


Allows application developers to customize the Domino Web 
server. 


Byte range serving 


This feature allows the Web client to download a file by 
requesting a byte range instead of the whole file. If a 
disconnect occurs during a download, the operation can 
resume from the point it was interrupted when the 
connection is restored. 


Caching enhancements 
for browser clients 


Performance improvements may be gained by allowing 
Domino-generated Web pages to be cached by browsers. 


CORBA/IIOP protocol 
support 


Domino R5 supports Common Object Request Broker 
Architecture (CORBA) and Internet Inter-ORB Protocol 
(MOP). 


Application server 


Database storage 
increased 


The previous maximum database size of 2 GB has been 
extended to 64 GB (at the time of writing this was the 
largest database that has been tested, not an architectural 
limit). This greatly improves scalability. 


Memory and I/O 
optimization 


Performance is a key focus area in the design of Domino R5. 
Several improvements to support more mail and database 
users on a single server have been introduced. These 
include: 

• Compression 

• Sequential I/O 

• A single buffer manager 

• Background I/O threads with read-ahead 


High Memory support 


With OS/2 Domino Release 5.02 server, the NSFBufferPool 
will utilize OS/2 High Memory support if this support is 
available. More detailed information on this can be found in 
5.3.2, “High Memory support” on page 154. 
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New feature 


Function 


Transaction logging 


Transaction logging provides better data integrity in case of 
a server failure. When logging is active, every transaction is 
first written to a sequential file and later propagated to the 
database file. In addition, transactional logging significantly 
improves server performance. Transactional logging also 
enables incremental database backup and faster system 
restart times after failures. 


Database fixup 
enhancement 


After a failure, fewer Domino R5 databases have to be fixed 
up prior to the system restart, improving server availability. 


Improved scalability 


As well as supporting much larger databases, Domino R5 
supports many more concurrent users than R4 running on 
similar hardware. 


Global database routing 


If a database is not available on one server, global database 
routing redirects the request to the closest replica copy of the 
database. 


High availability and scalability 


Internet Cluster 
Manager 


Web clients can now benefit from Domino failover and 
workload balancing features. This feature is discussed in 
detail in the book Netfinity and Domino R5.0 Integration 
Guide, SG24-531 3. 


Domino clustering 
enhancements 


Domino clustering functions have been improved over 
Domino R4. This includes: 

• Collaborative calendaring 

• Synchronous mail agent failover 

• Improved unread mark support of replicas 

• Better tailback functionality for the Notes Client 


Online indexing 


Allows access to database views that are currently being 
updated. 


Auto restart 
enhancements 


You can optionally keep the Domino server down after 
failures. This can be very useful in clustered configurations. 


Fast restart and 
recovery 


If the Domino R5 server fails, the server will automatically 
restart itself without performing a full initial startup. 


Online, in-place 
compaction 


You can now compact a database while it is in use. 


Online backup support 


Domino R5 introduces API commands to enable online 
incremental or full backups. This improves availability and 
allows third-party vendors to develop better backup solutions 
for Domino. 
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New feature 


Function 


Administration 


Upgrading users at 
registration 


Lotus provides integrated tools to migrate user registration 
information from your existing messaging system such as 
cc:Mail or Microsoft Exchange. 


Server setup 


The new server installation procedure enables you to install 
a Domino server without installing the Notes Client. 


Automated client setup 


The new installation method lets you create custom 
packages for automated install. This greatly decreases the 
cost of administration. 


Enhanced server setup 
profiles 


Allows you to create profiles for automated server installs. 


Administration Process (AdminP) 


Programmability 


Lotus has published a set of API calls to customize the 
Administration Process. This allows third-party vendors to 
provide customized administration tools for Domino server. 


Cross-domain 

functionality 


Administration process services are now also available 
cross-domain, allowing you to administer all the servers in 
your enterprise centrally. 


New administration 
interface 


Notes Client ships with the new administration application 
that lets you administer your Domino server faster and 
easier. 


Third-party integration 
options 


Lotus has published a set of APIs, enabling third-party 
vendors to enhance the administration utility. 


Desktop management 


Centralized client 
management 


You can customize client settings centrally, for example, 
setting proxy servers, bookmarks, and preferences. 


Centralized upgrades 


This feature allows you to push software upgrades to clients 
using e-mail. 


Telnet into server 
console 


You can administer the Domino server console from any 
workstation or server supporting the Telnet protocol. 


Batch console 
commands 


You can run, for example, a set of replication events directly 
from the server console by executing a single batch file. 


Decommission server 
analysis tool 


Simplifies consolidation of servers by comparing source and 
target systems when migrating Domino between platforms. 


Knowledge management 
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New feature 


Function 


Domain search 


This feature allows users to automatically search all 
databases within a domain. ACLs are incorporated into the 
search to ensure that only documents to which the user has 
the required access privileges are returned. 


Universal filters 


Domino R5 supports indexing and searching of attachments. 
The supported formats are: 

• Lotus WordPro 

• Lotus 1 -2-3 

• Lotus Freelance 

• Adobe PDF 

• WordPerfect 

• MS Word 

• MS Excel 

• MS Powerpoint 

• Ichitaro 

• HTML 


Paged result set 


The search results page may be customized and uses the 
common Internet search engine result page format. 


Full-text Service 
Provider Interface (SPI) 


Lotus provides APIs to allow third-party search engines to 
interrogate Domino databases. 


Full-text indexing of file 
system 


A single search finds the documents from both the Domino 
databases and the file system. This applies to the Web 
server only. 


Domain Catalog 


The central way of keeping track of database attributes (like 
the location of the closest replica of a database) to simplify 
knowledge management. 


’Note: Not applicable to Domino R5 for OS/2. 



1.5 OS/2 server environment 

For your convenience, this section provides a brief summary of each OS/2 
Warp Server product family. “Related publications” on page 321 lists 
redbooks about the OS/2 server family. 

1.5.1 OS/2 Warp Server V4 Entry 

This version of OS/2 Warp Server is known as Entry. If you need to support 
just a small number of users, this operating system should be suitable. If you 
work in a larger environment, you should use the Advanced version of OS/2 
Warp Server. File systems available in this release are FAT and FIPFS. As for 
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Domino R5, we cannot really recommend this server operating system 
release; however, the Domino R4.6 server, as well as the Domino R5, are 
certified to run on this server version. 

1.5.2 OS/2 Warp Server V4 - Advanced 

This version of OS/2 Warp Server is very powerful and supports a large 
number of clients. Among other features, the HPFS386 file system is 
available for this server. This file system works closely with the operating 
systems’ ring 0 and provides high performance as a file server. 

The Domino R4.6 server, as well as the Domino R5, are certified to run on 
this server version. 

1.5.3 OS/2 Warp Server V4 - Advanced SMP 

This version of OS/2 Warp Server V4 - Advanced supports multiple 
Symmetric Processors (SMP). This enhancement provides great 
performance for processor-intensive applications and extensive file I/O. 

The Domino R4.6 server, as well as the Domino R5, are certified to run on 
this server version. 

1.5.4 OS/2 Warp Server for e-business 

This latest version of the Warp Server family product provides powerful and 
scalable performance as a file server and an application server. HPFS386 
provides good performance, but it is not scalable. Journaled File System 
(JFS) provides scalable performance in an SMP environment. 

JFS is specifically targeted for large application servers missions, employing 
IBM application middleware, such as Lotus Domino server, DB/2, and Web 
application server. Performance of these application servers is comparable to 
earlier HPFS386-base Warp Servers, while providing increased scalability 
when installed on an SMP server. 

With the increase in disk and disk array size comes a need for larger 
partitions and files. JFS greatly expands the capacity limits inherent in earlier 
file systems on OS/2, while improving the recoverability of the system in case 
of server failure. In combination with the new Logical Volume Manager (LVM) 
feature, JFS also supports partitions that span physical volumes. 

The previous limit for OS/2 disk partitions was 64 GB, causing some 
customers to arbitrarily partition large disk arrays. JFS supports partitions up 
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to 2 TB and dynamic expansion, allowing tremendous flexibility in data 
storage and management. 

In cases of system and/or hard drive failures, JFS file system recovery time is 
significantly improved over HPFS386. While large HPFS386 partitions may 
require hours to recover, the JFS recovery time has been reduced to a few 
minutes by simply playing back its transaction log or journal to restore the file 
system. 

The traditional HPFS386 file system continues to provide world-class file and 
print performance for large enterprise environments and is available 
separately from the base product. 

Previously, SMP support for up to four processors was provided in an OS/2 
Warp Server V 4 - Advanced SMP. Now, OS/2 Warp Server for e-business 
supports up to 64 SMP configuration. 

OS/2 Warp Server for e-business provides a proven mission-critical 
foundation for the transformation to the Network Computing and e-business 
environments, while supporting legacy applications and integrating OS/2 
more tightly into the IBM family of business servers. JFS provides a 
state-of-the-art, quickly recoverable, transaction-oriented, log-based, 
scalable file system. The increased performance from scalability and the 
enhanced reliability that JFS provides make OS/2 Warp Server for e-business 
better suited than ever for Web and Domino serving. 

Domino server Release 5.0.2 is certified to run on this server. 

1.5.5 Workspace On-Demand 2.0 

Workspace On-Demand (WSOD) 2.0 provides enhanced remote boot 
capability to the OS/2 Warp family. This release can remotely serve DOS, 
Windows, and OS/2 Warp 4-based systems. 

In addition to IEEE802.2 remote boot protocol, DFICP boot sequence is also 
supported on this product to adapt to a Web-based application environment. 

When implementing this product, you have a suitable Network Computing 
environment for Lotus Notes R4.5x clients on OS/2 Warp 4 in combination 
with Domino R5 server on OS/2 Warp Server families. 

For information about how to install a Notes workstation on a Workspace 
On-Demand server, see Appendix E, “Enabling Lotus Notes on Workspace 
On-Demand 2.0” on page 309. 
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For more information, see: 

• Workspace On-Demand Handbook Release 2.0 , SG24-51 17 

• Workspace On-Demand Early Customer Experiences, SG24-5107 

1.5.6 Workspace On-Demand 2.0 feature for Windows clients 

IBM released a new feature for Workspace On-Demand 2.0. This feature 
provides a remote installation and management environment of Microsoft 
Windows 95/98/NT from OS/2 Warp Server families. 

Using this feature, you can deploy Domino Administrator and Notes 
workstation on the Microsoft Windows operating systems mentioned above. 

Data directory support for WSOD Win32 clients 

Domino R5.0.2 supports Win32 client data directories on an OS/2 network 
drive. This allows WSOD Win32 clients to talk to a Domino 5 server. 



For more information, see Workspace On-Demand 2.0 Feature for Windows 
Clients, SG24-5396. 



1.6 Other Lotus Notes/Domino components for Windows 

The Notes Client for Windows has been divided into four packages to 
separate different functions. These functions are client/server administration, 
application development, and a new mail notification utility called Lotus 
Minder. Notes R5 Client is not released for OS/2 platforms. However, it is a 
good idea to know what the Notes R5 Client is, and what other enhanced 
client components do. 

Each component can be installed independently of the others. Therefore, if a 
user needs to send and read mail, access Domino databases, and manage 
Domino servers, but is not involved in application development, only the Lotus 
Notes and Lotus Domino Administrator components need to be installed. This 
saves disk space. 

Domino server can also be installed without the Notes Client. This provides 
added security, since no one can then access Notes databases locally. 

1.6.1 New features in the R5 Notes Client for Windows 

As described in the above section, the number of Domino server 
enhancements and innovations are significant. Looking at the new features in 
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the R5 Notes Clients (shown in Table 2), we see that some are common to 
both the client and server. These are listed here again for ease of reference. 



Table 2. New features in the R5 Notes Client 



New feature 


Function 


General features 


Notes Client user 
interface 


The Notes Client user interface has been completely 
redesigned. The new interface integrates regular Notes 
Client function and access to the Web better than ever 
before. Calendar now allows more than one calendar to be 
open at once, and navigation between windows is easier 
and faster thanks to the Navigation bar and Headlines 
page. 


Separate server and 
client components 


You can now install a Domino server without installing a 
Notes Client. This enables better security and frees up 
server resources. Three different clients are available for 
optional installation: the standard Notes Client, the Lotus 
Domino Administrator, and the Lotus Domino Designer. 


Domino Directory 


Domino Directory is equivalent to the Public Address Book 
in earlier releases of Domino. 


Directory Catalog 


This catalog is a highly compressed and scalable 
concatenation of the Domino Directories in the enterprise. 


Directory Assistant 


Directory Assistant is equivalent to the Master Address 
Book. 


Interoperability features 


POP3 and IMAP4 
support 


The Notes Client is a full-capacity POP3 and IMAP4 client. 
Notes can be used to fetch and send Internet mail messages 
from any standard Internet mail server. The Notes Client can 
also be used in place of other mail clients, even if the user 
has more than one Internet mail account. 


Native MIME support 


MIME is the message format used for Internet mail to support 
content other than plain text. Notes mail now supports MIME 
directly, which means no conversion is required when 
interchanging mail across the Internet. Notes also supports 
S/MIME, the secure version of MIME. 


X.509 certificates 


The use of X.509 certificates allows interoperability with 
other certificate authorities. 


Internet addressing 
support 


Internet addressing is a native addressing format in Domino 
Release 5. 
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New feature 


Function 


LDAP support 


Lightweight Directory Access Protocol (LDAP) is a directory 
service protocol that runs over TCP/IP. LDAP contains 
hierarchically arranged entries of person information. The 
hierarchy is often arranged to reflect an enterprise 
organization chart. 


Support for Microsoft 

IIS 


Internet Information Server (IIS) can now be used as an 
alternative to the native Domino HTTP engine for 
Web-enabled applications. 


Mail features 


Headlines 


The user sees a Welcome page called Headlines when the 
Notes Client is started. Lotus provides some standard 
Headline screens, but users have an option to create their 
own Headlines. Headlines provide an easy entry-point to 
mail and calendar functions, as well as to the Web. You can 
see an example of this in Figure 1 on page 19. 


Subscriptions 


Subscriptions work together with Headlines. A user can 
subscribe to a Domino application and display requested 
information on the Welcome page. 


Bookmarks 


Bookmarks replace the Notes desktop. You can add any 
Domino database, database view, or URL link to bookmarks 
to easily access the most often used information in your 
enterprise. Existing Web bookmarks are automatically 
imported from Netscape Navigator or Microsoft Explorer. 


Navigation bar 


This gives you the ability to navigate the Notes interface 
quickly and easily. 


Window tabs 


The Notes Client Window menu has been replaced with the 
Window tabs feature. Each open window is represented by a 
small tab on the screen, and you can easily jump between 
open windows or close a window without activating it first. 


Enhanced views 


The calendar view has had several improvements. You can 
now, for example, see the start and end times, the 
chairperson for the meeting, and the meeting location. 


Print preview 


The new Print dialog window enables you to preview the 
layout prior to printing. You can select from several different 
predefined print layouts, or create your own custom layout. 
This is especially useful for mail and calendar printing. 


HTML editing 


Notes fully supports the HTML 4 standard. You can view any 
Web page’s HTML code from Notes and create your own 
HTML documents. 



Introduction 15 






New feature 


Function 


Improved table features 


Table features in Release 4 were relatively limited. The new 
version significantly enhances them. You can now create 
brand new table types including animated, tabbed, and linked 
tables with the standard table style. 


Drag-and-drop 


You can use drag-and-drop techniques to link information 
between different views. This works especially well for 
bookmarks. 


Mail preferences 


You now have greater flexibility to customize your mail 
settings. Preferences include, for example, automatic 
spell-checking on messages sent, as well as delivery priority 
and message importance. 


Signature files 


This feature allows you to automatically import a predefined 
signature for use with every message you send, to add 
contact information at the end, for example. HTML is 
supported, which enables you to use an animated GIF file for 
your signature. 


Type-ahead addressing 


This has been enhanced from the previous release. 


Mail rules 


You can filter mail automatically according to the rules you 
define. 


MAPI support 


Notes Client is MAPI enabled, which makes it possible to use 
Notes as your mail client from other applications supporting 
MAPI. For example, you can send an Internet message from 
Internet Explorer using Notes. 


Notes Minder 


Notes Minder is a notification utility for Windows 95/98/NT 
platforms. It periodically checks for new mail or missed 
alarms while the Notes Client is not actually running. 


Calendar features 


Calendar preferences 


The calendar preferences let you, for example, define your 
free time information, or set delegation information. 


Support for paper types 
and sizes 


You are not limited to any special paper type or size. You can 
select the hard copy format that best suits your needs. 


Group calendar view 


You can now open several people’s calendars at the same 
time. You can define one or more group calendars to gain a 
convenient overall view of your colleagues’ or team’s 
schedules. 


Holiday support 


Administrators can define company holiday schedules, which 
users can then add to their personal calendars. 
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New feature 


Function 


Improved invitation 
form 


Gives you more versatility when sending invitations. 


Resource management 


Release 5 gives you more flexible ways to manage 
resources. One of the new features is offline booking of 
resources. 


Enhanced alarm 
support 


You can now choose to play a .WAV file as an alarm to notify 
you about upcoming meetings or appointments. Alarms can 
now also be sent to attendees. 


Owner Actions button 


You can easily reschedule, cancel, or confirm a meeting as 
chair person. You can also view participant status. 


Participant Actions 
button 


A participant can easily accept, decline, delegate, or propose 
a new time for a meeting with a single button. 


Copy Into button 


You can copy the contents of a meeting invitation, task, or 
e-mail into a new memo, calendar entry, or task. 


Mobile features 


Disconnected use 


Additional offline capabilities have been introduced in 
Release 5. 


Lightweight Mobile 
Directory 


This feature enables you to store user directories with 
hundreds or thousands of entries on your local machine 
without using large amounts of disk space. The Lightweight 
Mobile Directory is optimized for mobile use by storing only 
critical information. 


PDA support 


Notes supports Personal Digital Assistant (PDA) devices to 
allow you to synchronize your calendar and mail between 
your PC and your PDA. 


Locations 


Lotus provides a wizard to simplify creation of location 
documents for different configurations. 


Collaboration features 


Search 


Now the search button is always visible. The search feature 
has been enhanced in several ways, including: 

• Improved dialogs 

• Paged result set 

• Summarization of search results 


Localization features 
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New feature 


Function 


Enhanced language 
support 


Two new languages have been added in R5: Arabic and 
Hebrew. Vietnamese will be added later on, bringing the total 
number of supported languages to 41 . Language switching 
on the fly is supported. 


Enhanced Unicode 
display 


Notes displays characters of any character set on any 
language platform. 


BiDi support 


Support for bidirectional text. 


Alternate name support 


Notes now support two different names stored in a single ID 
file. For example, you can store a name with Roman 
characters and add a second name using Japanese 
characters. 


Spell-checker 

enhancements 


There are several new features including recognition of 
names and several new language dictionaries including 
Finnish, Hungarian, Polish, and Hebrew. 


Keyboard switching 


Automatic keyboard layout switching on the fly is allowed. 


User-selectable 
character set 


You can reload a mail message with the correct character 
set. 


Automatic language 
switching 


A document on server can have a language tag, enabling the 
Web client to display the appropriate language version of the 
document when the feature is active on both client and 
server. 



The Notes Client user interface, only available for the Windows family 
(Windows 95, 98, NT), has had several major changes since Release 4. First 
of all, the Notes work space, although still available, is no longer the preferred 
way to view your data. When you open the Notes R5 Client, a Welcome page 
is displayed. This default Headlines page allows you to navigate to your Mail, 
Calendar, Personal Address Book, and the To Do list. You can select between 
a number of predefined pages or create and customize a page of your own. A 
customized Headlines page is shown in Figure 1 on page 19. Here, the user 
has decided to display their inbox, Calendar, and a Web page in the same 
window (items 5, 6 and 7, respectively). 
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1. Window Tabs 



2. Welcome page style 



3. Navigation Bar 



4. Bookmarks 



5. Mail Inbox 



6. Calendar 



7. Browser window 



Figure 1. The new Notes Client user interface 

Window tabs (1 in Figure 1) replace the Window menu. Now, you can jump 
between Notes windows quickly by clicking the relevant tab. 

The Welcome page, also referred as the Headlines page, can be selected 
and customized using the drop-down list and the Options button (2 in Figure 
1). You can choose what kind of information you want to display at startup 
and select a preferred layout. 

The Navigation bar (3 in Figure 1) lets you switch between documents or 
recently opened views in much the same way as Web browsers do. You can 
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also refresh the current page using the Refresh button. It does not matter 
whether the active page is a Web page, a view of your incoming mail, or your 
calendar. You may also open a URL link here. 

Bookmarks buttons (4 in Figure 1 on page 19) are used to navigate between 
your Mail, Calendar, To Do list, and your databases. So Bookmarks, in fact, 
replace the work space in Notes R4. You can add the most frequently 
accessed Domino databases to the Favorites bookmarks folder. You can also 
bookmark your favorite Web links, and bookmarks that you have set up in 
Netscape Navigator or Microsoft Explorer are also accessible from here. 

1.6.2 Lotus Domino Administrator R5 for Windows 

Lotus Domino Administrator is used to maintain and administer your Domino 
environment. Using this client gives authorized individuals the ability to 
perform the day-to-day administrative tasks necessary to keep your Domino 
environment running smoothly. For example, you can register servers, 
people, and organizations, set rules for Internet addresses, monitor your 
Domino servers, display logs, and stop and start server tasks. 

The Administrator tool in R5 (see Figure 2 on page 21) also allows you to 
administer Domino servers in another Notes domain. This enables larger 
organizations to administer their entire enterprise infrastructure at a single 
point of control, if so desired. 

For more information about managing your Domino server with this client, see 
7.3, “Using Domino Administrator for Windows” on page 237. 
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Figure 2. Lotus Domino Administrator R5 



1.6.3 Lotus Domino Designer R5 for Windows 

The Domino Designer tool is used to create and modify databases and 
applications. Much of the basic function of the designer is carried over from 
Notes R4, such as support for Notes functions and LotusScript and creation 
of forms and views for databases. 

Figure 3 on page 22 shows the Lotus Domino Designer R5. 
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Figure 3. Lotus Domino Designer R5 

Like the other client components, the user interface has changed since R4. 
However, there are quite a few new features as well, including: 

• Outlines are provided to act as skeletons for your applications. 

• Pages can now be used to display information, links to documents, and 
views in the database. 

• You can now create framesets in Domino without any HTML code. 
Framesets are commonly found in many Web pages. 

• A design synopsis feature lets you generate a detailed database report 
that includes the database size and the access control list. 

• JavaScript support has been added. 

If you want to know more about application development for Domino R5, refer 
to Lotus Domino Release 5.0: A Developer’s Handbook, SG24-5331 . This 
book describes how to use LotusScript, JavaScript, HOP, CORBA, and other 
advanced features within Domino R5. You can also learn how to create 
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multilingual applications. The publication is available on the Internet at the 
following URL: 

http : / /www . lotus . com/recLbooks 
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Chapter 2. Preparing for installation 



This chapter discusses network-related issues, such as how to configure 
TCP/IP protocol and NetBIOS protocol on OS/2 Warp Server. To get 
maximum performance and the maximum number of users for these protocol, 
we need to carefully configure MPTS and LAN Server/Requester (if you 
choose to use NetBIOS). 

TCP/IP protocol is always required 

As of this release, Domino requires the TCP/IP protocol for installing and 
configuring the product and for Web administration. 



2.1 Hardware requirements 

Resource requirements will be different depending on the server’s role, the 
number of clients supported, performance requirements, and so forth. This 
section shows the minimum hardware requirements for Lotus Domino R5. 

Table 3 shows the basic hardware requirements of Domino R5 for OS/2. 
Actual resource requirements may be different depending on server 
configuration. For performance tuning information, see Chapter 5, 
“Optimizing your Domino environment” on page 145. 

Table 3. Resource requirements for the OS/2 platform 



Platform 


OS/2 


Certified operating systems 


IBM OS/2 Warp Server V4 
IBM OS/2 Warp Server Advanced V4 
IBM OS/2 Warp Server Advanced SMP V4 
IBM OS/2 Warp Server for e-business 


SMP support 


Yes 1 


RAM 


48 MB minimum 

128 MB or more recommended 


Disk space 


750 MB minimum 2 
1 GB or more recommended 


Disk swap space 


16 MB 



©Copyright IBM Corp. 1999 
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Platform 



OS/2 



Notes: 

1 ) Only available on Warp Server V4 Advanced SMP and Warp Server for e-business 

2) Disk space requirements include estimated free disk space amounts for a 
functioning Domino system (that is, one or more mail databases and applications). 
The actual disk space needed to install the Domino files is lower than the minimum 
and recommended values. Installing the Domino server software on an OS/2 system 
requires a HPFS, HPFS386, or JFS volume, because some Domino installation file 
names exceed the FAT limitation of the 8.3 file-naming convention. 



2.1.1 Network protocols supported 

Table 4 describes which protocols are supported by Domino R5 for OS/2. For 
more detail, see 2.1.1, “Network protocols supported” on page 26 and 2.2.2, 
“Running Lotus Domino R5 on NetBIOS” on page 29. 

Table 4. Supported protocols on Domino R5 for OS/2 



Protocol 1 


Support 


NetBIOS/NetBEUI 2 


Yes 


NetBIOS over TCP/IP 


Yes 


TCP/IP 


Yes 


X.PC 3 


Yes 


Notes: 

1 ) Other protocols that are not on the list, for example, SPX/IPX, VINES, and so on, are 
not supported. 

2) Notes SPX and NetBIOS port driver (Novell NetBIOS) are not certified or supported 
on an OS/2 Warp Server platform. 

3) Analog modem or ISDN modem using AT command strings. 



2.1.2 CPU considerations 

In this section, we review CPU considerations briefly, including: 

• Overview of CPU usage 

• SMP enabling 

2. 1.2.1 CPU 

Before upgrading your existing R4 system to R5, you should make sure that 
the CPU is not close to becoming a bottleneck. You can use Netfinity 
Manager to collect information on CPU utilization information. Other vendors 
provide their own tools for these purposes. The average CPU utilization 
should not exceed 70 percent. If the average is higher than this, the CPU is 
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becoming a bottleneck. Peak values can be higher or even 100 percent, but 
the peak should not last for too long a time at this value. 

When speaking about processing power, there are three issues to be 
considered: the CPU speed, the number of CPUs, and the size of the L2 
cache. Tests have shown that a larger L2 cache gives a noticeable 
performance boost. On Windows NT, we have seen about 10 percent 
improvement when the L2 cache has been upgraded from 512 KB to 1 MB. 
The actual improvement varies depending on the number of CPUs installed. 
The same kind of results are also expected on the OS/2 platform. 

Adding more CPUs requires that you must be running the SMP version of 
OS/2. OS/2 provides a robust multiprocessor environment and is a very good 
choice for running Domino. You should note, though, that adding an extra 
CPU does not double the CPU performance. Part of the CPU cycles will be 
used for multiprocessor management because there is no dedicated 
processor for that purpose in Intel platform design. 

Upgrading the processor is one of the options for better performance as well. 
If you look at the raw processing power, a 2-way Pentium 400 MHz Pentium II 
Xeon processor doubles the 2-way 400 Mhz Pentium Pro performance. The 
actual performance difference in a real production environment is not that 
large. 

2. 1.2. 2 Symmetric Multiprocessing (SMP) 

The design of Domino has fundamentally changed. Conceptually speaking, in 
the R4 design, each client is handled by a dedicated thread. This thread waits 
for user input and then handles the client's transaction from beginning to end. 
This design minimizes inherent latency (wait time) and gives optimal CPU 
processing time per transaction. However, the design has other inherent 
limitations. Although any individual client interacts relatively infrequently with 
the server, the client's dedicated thread consumes server system resources 
at all times. Large client populations require large numbers of threads and 
system control blocks associated with these threads. This design does not 
scale well to large client populations. 

The R5 design uses temporary worker threads to handle client transactions. 
Some of the worker threads handle network I/O, and other workers handle 
disk I/O. Handling a client transaction involves scheduling units of work to 
pools of worker threads. Conceptually, this design allows very large client 
populations because individual clients consume minimal system resources 
when not in the midst of performing a transaction. However, this design has 
inherent latencies and more path-length per transaction due to worker thread 
scheduling overhead. 
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From the above discussion, one should expect that Domino R5 needs more 
processing power per transaction compared to R4. Also, the minimum 
response time for Domino R5 transactions is longer than the same 
transaction on R4. These expectations are proven in the measurement data. 



2.2 Software requirements 

Domino R5 is required to be configured from a Web browser after basic 
installation. TCP/IP must be installed and configured on the Domino R5 
server. Therefore, make sure the latest FixPaks are applied to your system. 
For information on currently available FixPaks, refer to Appendix A, 

“Obtaining FixPaks” on page 283. 

2.2.1 Running Lotus Domino R5 on TCP/IP 

The preferred protocol to be used in a Domino R5 environment is TCP/IP. 
Unless you already have TCP/IP in your network, implementing TCP/IP is a 
very complex undertaking and is beyond the scope of this document. The 
following sections assume that TCP/IP is installed and configured properly. 

2. 2. 1.1 Name resolution using DNS 

If you intend to have Domino server names resolved rather than specifying an 
IP address, there are several ways to accomplish this. 

Apart from local files, such as HOSTS, if a Domain Name System (DNS) is 
available and set up for your Domino servers, a Domino server name can 
resolved through the following methods: 

• A fully qualified DNS name, for example, domino.banking.net. 

• Assuming the system is in the DNS scope, the host name, for example, 
domino, may be used. 

2. 2. 1.2 Name resolution using Domino documents 

A Domino connection document must have been previously created on the 
first Domino server in the Domino domain. For more details, please refer to 
3.2.6, “Choosing administration settings for the additional server” on page 73. 

A summary of the name resolution order in a TCP/IP environment is as 
follows: 

1 . Use a previous successful connection (if there is any). 

2. Use a server or connection document. 
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If you use an IP address rather than DNS name, IP address resolution will 
be immediately done with the connection document. 

If you use a DNS name rather than IP address, IP address resolution will 
be done by using DNS name resolution, asking the DNS server, and/or 
using the hosts file. 

The DNS name must be resolved by using the DNS name server or hosts 
file. 

3. Use a fully qualified Internet address. 

If you do not have a server or connection document, a fully qualified DNS 
name will be used to resolve the IP address by asking DNS server. 

If you use only a host name for the server name, name resolution will be 
limited within a single domain if you use a DNS server. 

4. Use a passthru server. 

If all the above methods fail, a passthru server will be used for name 
resolution. Do not forget that locating a passthru server also requires 
name resolution. 

2. 2. 1.3 Name resolution using a Domino name server 

During configuration of either a Domino server or Notes workstation, if the 
server you are trying to connect to is not able to be resolved using TCP/IP, a 
dialog box appears allowing you to enter a server name and IP address using 
the same rules as described above. Although the dialog box indicates that 
you should enter a secondary name server, you can enter the IP address of a 
Domino name server and the IP address for your mail server instead of the 
secondary name server and address. Domino stores these values in a 
location document in the Domino Directory (formerly called the Personal 
Address Book). 

More details about name resolution logic can be found in Appendix C.3.2, 
“How servers make a connection” on page 304. 

2.2.2 Running Lotus Domino R5 on NetBIOS 

Domino R5 provides only one port driver, inetbios.dll, for the IBM NetBIOS 
protocol. In the previous Domino release, the iibmeenb.dll driver was 
provided. Starting with Domino R5, you need to have LAN Requester 
installed on the machine because the inetbios.dll driver requires the IBM LAN 
Requester to be running. 
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2. 2. 2.1 Domino server NetBIOS resource usage and limitations 

The OS/2 LAN Server (ibmlan.ini) and MPTS (protocol.ini) configuration files 
contain default values for maximum sessions, commands, and names for 
NetBIOS. The default NetBIOS resources should be appropriate for Notes 
workstations, but may not be appropriate for some Domino servers. In this 
section, resource usage rules are discussed. 

Domino R5 for OS/2 only provides an inetbios.dll port driver for OS/2 
NetBIOS protocol. NetBIOS resources are shared by the LAN 
Server/Requester and Domino port driver. To configure Multiple Protocol 
Transport Services (MPTS) and OS/2 LAN Requester correctly, we have to 
know how NetBIOS resources are used by the Notes Client and OS/2 LAN 
Requester. 

A Notes workstation that uses NetBIOS protocol uses one session and one or 
two commands for reading or writing databases. 

Although the NetBIOS protocol on OS/2 supports a maximum of 1000 
sessions, the inetbios.dll port driver only supports a maximum of about 100 
users. This is regardless of the NetBIOS resources, number of adapters, and 
so forth. This is due to the way this port driver uses 16-bit named system 
semaphores. 

2. 2. 2. 2 MPTS configuration 

To determine the values used to specify the NetBEUI capacity parameters, 
we need to know the RAM usage of the IBM OS/2 NetBEUI protocol driver so 
that total system RAM usage does not exceed 64 KB. Table 5 lists the RAM 
usage (in bytes) per item, as well as the parameter corresponding to each 
item as it is displayed on the Parameters for IBM OS/2 NetBIOS window. A 
distinction is made between 386 and Pentium-based workstations. (Note that 
the figures for 386-based workstations also apply to 486-based and 
Pentium-based workstations.) 

An applet, nb64k.exe, is provided to assist in these calculations. If this tool is 
not available, the following tables are provided. These values may vary 
between releases, but the nb64k.exe tool can be used to detect any changes. 
nb64k.exe does not update the protocol.ini file. New values must be entered 
using the MPTS Configuration Utility. Read the table as follows: Setting the 
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GDT selectors parameter to 1 5, for example, results in adding 1 50 bytes (1 5 x 
10 bytes) to the total system RAM usage. 

Table 5. IBM OS/2 NetBEUI RAM usage 



Data area item 


Related parameter 


RAM usage in 
bytes (386 CPU) 


Overhead for adapter work and 
communication area 


N/A 


7800 


Each name 


Maximum names 


76 


Each session 


Maximum sessions 


0 


Each selector 


GDT selectors 


10 


Each name in remote name 
directory 


Number of names in remote 
name directory 


0 


Each l-packet 


l-frame descriptors 


108 


Each Ul-packet 


Ul-frame descriptors 


124 


Each loopback packet 


loopback frame descriptors 


148 



The total system RAM usage is the sum of the RAM usage for all data area 
items. 

For 386-based workstations, the sum of RAM usage for all data area items 
except Maximum sessions must be less than or equal to 64 KB: 

7800 bytes overhead 

64 bytes x Maximum commands 

76 bytes x Maximum names 

10 bytes x GDT selectors 

108 bytes x l-frame descriptors 

124 bytes x Ul-frame descriptors 

148 bytes x Loopback frame descriptors 

<= 64KB (65535 byte) 

With the above restriction, we can allocate NetBIOS resources for any 
NetBIOS application including the IBM LAN Server and Requester. The 
parameters we need to know are as follows: 
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• Maximum sessions 

This must be less than or equal to 254. 

• Maximum commands 

This must be less than or equal to 255 for NetBIOS over TCP/IP. 

This must be less than or equal to 3,000 for OS/2 NetBIOS. 

• Maximum names 

This must be less than or equal to 254. 

2. 2. 2. 3 IBM LAN Server/Requester configuration 

The MPTS configuration provides the minimum amount for NetBIOS 
resources. The OS/2 LAN Server/Requester uses its own resources from this 
global resource pool provided by MPTS. The Domino server will use its own 
NetBIOS resources from the ones that have been allocated for the LAN 
Server and Requester. 

The laninst . exe command is available to configure NetBIOS resources for the 
OS/2 LAN Server and Requester. 

Assign the following NetBIOS resources for LAN Servers and Requesters for 
each logical/physical adapter: 

• Sessions should be less than or equal to 254. 

• Commands should be less than or equal to 255. 

• Names should be less than or equal to 254. 

As a general rule, allocate twice as many commands as sessions, plus five 
additional commands. For example, if you need 100 sessions, then allocate 
205 commands. 

MPTS allows you to have 1000 sessions on one physical network adapter 
configuring four NetBIOS over TCP/IP or using four physical network 
adapters. 

Note 

The recommended values apply only to Domino. These values are in 
addition to those required by or already allocated for LAN Server 
(ibmlan.ini) or other NetBIOS applications in the system. The sum of all 
these NetBIOS resources must not be greater than the global settings in 
the protocol.ini file. 



For more information on changing the maximum sessions, commands, and 
names values for LAN Server Resources (ibmlan.ini), see the online book 
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Performance and Tuning, which is also shipped with the OS/2 Warp Server 
families. 

2. 2. 2. 4 LAN Requester considerations 

The netbios.dll network driver uses the Submit interface and makes calls to 
the netapi.dll dynamic link library. To use this network driver, you need to 
install File and Print Services and have LAN Requester running before you 
start the Domino server. 

Note 

During the setup process, the LANO port driver is used by default if you 
select to install the NetBIOS driver. If you do not have the File and Print 
Services installed on your system, the setup process may not finish 
correctly. 



To avoid a duplicate name on the network, the first 15 characters of the 
Domino R5 server name must be unique within the NetBIOS network. 

2. 2. 2. 5 Configuration parameters for the iibmeenb.dll port driver 

The following parameters are no longer valid for the Domino R5 server: 

• NETBIOS_lana_resource_program 

• NETBIOS_resource_program 

• NETBIOS_resource 

These parameters are for the R4.x ibmeenb.dll port driver, which is no longer 
included in R5. 

2.2.3 File system considerations for Domino R5 

A file system is essentially a hierarchical structure of directories, each 
directory containing either more directories (referred to as subdirectories) or 
files. The main purpose of the file system is improve management of data by 
allowing the data to be organized and easily managed. 

With the increase in disk and disk array size comes a need for larger 
partitions and files. This rise in storage capacity has facilitated the need for 
improved file system management and recovery. 

IBM OS/2 Warp Server for e-business introduces two key features to help 
meet new server demands: the Logical Volume Manager (LVM) and the 
Journaled File System (JFS). JFS is designed for high throughput and 
reliability, as well as providing quick recovery times that are essential factors 
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in improving server availability and performance. It is specifically targeted for 
large application server missions running on an SMP server, such as Domino 
server. Performance of these application servers is comparable to earlier 
HPFS386-based Warp Servers on SMP machines, while providing increased 
scalability when installed on SMP servers. In combination with the new 
Logical Volume Manager (LVM) feature, JFS also supports partitions that 
span physical volumes. 

Note 

Since JFS is a Ring-3 implementation it is highly recommended to use 
SMP machines because the file system competes with application serving. 
HPFS386, which is a Ring-0 implemention, is always faster than JFS. The 
more processors there are, the closer the performance towards HPFS386 
file system. Domino R5.0.2 and later are certified to run on the JFS file 
system. 



The previous disk partition limit was 64 GB and the previous file size limit was 
2 GB. JFS supports partitions and files of up to 2 TB, as well as dynamic 
expansion, allowing greater flexibility in data storage and management. 

Domino R5.0.2 takes full advantage of JFS, and therefore, files can now be 
as large as the partition size, up to 2 TB. 

Along with file system and file size growth, Domino databases can also grow 
larger than in previous versions. Domino R5.0.2 now supports databases 
larger than 2 GB. 

The JFS file system recovery time, required during system failures and hard 
drive failures, has been significantly improved when compared with 
HPFS386-based OS/2 Warp Servers. While large HPFS386 file systems 
could require hours to recover, generally, that time has been reduced to 
minutes for JFS, which is able to simply play back its transaction log or 
journal to restore the file system. 

The traditional HPFS386 system continues to provide world-class file and 
print performance for large enterprise environments. If you want to use 
HPFS386 with Warp Server for e-business, it can be purchased separately. 

The choice of the most appropriate file system is important for the 
performance of your system. This section summarizes the performance and 
key features of the supported file systems and discusses where it would be 
most appropriate to use them. 
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File Allocation Table (FAT) 

One of the simplest methods for storing data on disk is with File Allocation 
Table (FAT). FAT is a file system, but not an Installable File System (IFS). It is 
a part of the operating system kernel. FAT is simply an unsorted linear table 
designed for locating directories and files. It has low memory and disk 
administrative overheads. FAT is best suited for small disk systems, namely 
floppy disks, since it was optimized for performance by reading the FAT 
content into memory. Today, when hard disks sizes are in gigabytes or in tens 
of gigabytes, FAT is a very poor choice because of its design. For example, 
because on large hard disks the allocation table is very large and cannot be 
read into the memory as a whole, the hard drives have had to make several 
head movements to read a single file, which has had an overall effect of 
slowing down the system. 

Important 

The FAT file system is not suited for Domino because of its inherent design 

limitations. Domino requires long file name support. 



The original implementation of FAT had a partition limit of 32 MB, which was 
later increased to 2 GB. One of the biggest problems with FAT has been the 
automatic incremental jump in allocation unit size when the disk partition size 
increases. An allocation unit is the smallest addressable unit on the disk. This 
has lead to large amounts of disk storage wastage with small files. For 
example, on a 560 MB disk partition, the allocation unit is 16 KB. So, if you 
store a 1 KB file on the disk, it will actually take up 16 KB of disk space. 

Another problem stems from the way data information is written one after 
another, in a chain, to disk. It starts from the outer edge of the disk, fills in 
towards the middle, then starts at the outer edge again. This quickly leads to 
disk fragmentation since space forms in the middle of the chain from file 
deletion. As a file gets modified, parts of it can end up being stored in 
different areas of the disk, resulting in excessive head movement and slow 
response times. Finally, FAT is restricted to an 8.3 naming convention, often 
preventing meaningful names from being given to files. 

2. 2. 3.1 High Performance File System (HPFS) 

FIPFS addresses some of the concerns that are prevalent with FAT. HPFS is a 
16-bit implementation file system and was created specifically for a 
multitasking environment. It is especially efficient when handling large 
partition sizes and large numbers of files. One thing you should avoid is 
allocating more than 5000 files in a subdirectory or directory. When you 
exceed 5000 files, you will start to degrade performance. The HPFS file 
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system shipped with the OS/2 Warp 4 and Warp Connect product has a 
cache limit of 2 MB. There is no such limit when using the HPFS386 file 
system shipped with OS/2 Warp Server Advanced. HPFS also followed a new 
concept in file system implementation called the Installable File System (IFS). 
An IFS is a file system that is not imbedded into the kernel. An IFS driver, 
which contains code needed to manage media formats other than DOS, is 
loaded during the system boot phase. 

HPFS has, by design, a better structure than FAT that prevents data 
fragmentation. This is due to the new disk layout, whereby, the tables that 
describe the location of files and free space are positioned at regular intervals 
throughout the partition from the center of the disk. Also, new file and 
directory information is written where there is enough free space. This 
reduces fragmentation and prevents excessive movement of the disk arm(s). 
HPFS supports only a 512 byte allocation unit (cluster size) no matter how 
large the partition becomes and also supports long file names up to 255 
characters. Critical for the high performance of HPFS is the caching 
technology it uses to access the disk. The lazy-write design writes data to a 
memory cache before writing to disk, giving faster overall performance. The 
drawback is that data may be lost if the computer is suddenly turned off 
preventing the cache from being written to the disk. 

Data location by the file system is also improved in HPFS through the use of a 
sorted Balanced tree (B-tree) structure to store the file information. This 
speeds up the searches for files because HPFS can quickly transverse down 
the correct branch of the tree to locate the file, whereas FAT has to look 
sequentially through an unsorted linear table. The drawback of this process is 
that it takes slightly longer to write the file, but it is greatly compensated by 
the speed of locating a file. 

Note 

HPFS is not recommended for Domino due to limited cache size. 



HPFS cache 

If you have installed your Domino server on a standard HPFS drive, you 
should specify the cache size and the caching record threshold in the IFS= 
statement in the config.sys file. The IFS statement is described below. 

Syntax for HPFS initialization is: 

IFS=pathname [/CACHE : <size in kilobytes>] [/CRECLrx parameter] [ /AUTOCHECK: drive [drive ... ] 

For example, to set the cache to 2 MB and enable auto checking on drive C: 
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IFS=C: \0S2\HPFS . IFS /CACHE:2048 /CRECL:4 /AUTOCHECK:C 



The explanations for each parameter are shown in Table 6. 



Table 6. HPFS initialization parameters 



Parameter 


Description 


pathname 


Specifies the pathname of the HPFS IFS. 


/CACHE:<size in kilobytes> 


Specifies the amount of memory in KB that is 
used for file system disk caching. If this 
parameter is omitted, the default value is 10 
percent of the available physical memory. 

The maximum size is 2048 KB. 


/CRECL: x 


Specifies the maximum record size forcaching 
where the maximum record size (x) is a 
multiple of 2 KB. The smallest maximum 
record size for caching is 2 KB and the largest 
is 64 KB. The default is 4 KB. 


/AUTOCHECK:drive[drive...] 


Tells the system to check each drive listed to 
see if it was shut down properly. If not, it will 
run CHKDSK on only the drives indicated. 



HPFS386 

With the release of the 80386 (and higher) class of microprocessors, the 
HPFS design was able to be further enhanced and tailored for the networking 
environment, resulting in a new version of HPFS called HPFS386. Bundled 
with the Advanced version of the server code, HPFS386 provides extremely 
fast access to large disk volumes and optimized performance in the server 
environment. 

HPFS386 is a 32-bit implementation of a file system and was developed to 
tightly integrate with the server code, at Ring 0, allowing data to be 
transferred directly from the HPFS386 cache to the network adapter driver. 
This resulted in accelerated network I/O, leading to faster data access by 
clients. Other features incorporated in HPFS386 were a greatly increased 
cache size, local security, software fault tolerance support for RAID-1 
(mirroring and duplexing), directory/user-based disk space limitation, and 
increased file access-related limits. An advantage introduced with HPFS386 
was the storage of Warp Server Access Control Lists (ACLs) within the 
directory and file structures, thus making fast user verifications leading to 
faster client access to the file. ACL information in HPFS is stored in a 
separate file called net.acc, and the overhead of accessing this file slows 
down verification. 
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For file server implementation, the decision between HPFS386 and JFS is 
dependent upon the server configuration. The biggest drawback with 
FIPFS386 is recovery time considerations when the system crashes, and the 
system is configured with very large disk partitions. Recovery still relies on 
chkdsk to check and fix disk errors. 

HPFS386 cache 

You can tune the HPFS386 file system by adjusting the size of the disk cache. 
To do this, you must edit the hpfs386.ini file and change the cachesize 
parameter or increase the installed physical RAM. 

The HPFS386 cache is not pageable and will reduce the amount of memory 
available for other applications running on your server, including Domino. This 
may result in increased swapping on a memory-constrained machine. If 
heavy swapping occurs, you should decrease the size of the HPFS386 cache. 

HPFS386 will not use all the memory spaces. Cache usage is limited to 60 
percent of the available memory as a default and big buffers space and 
request buffers space are also defined by the parameters. Correctly 
managing the cache size can lead to significant performance improvements 
on the server system and improve performance of applications with high disk 
I/O requirements. 

HPFS386 can also take advantage of the lazy-write function. This can provide 
significant performance improvement when writing to disk. However, if 
security and auditing is of major importance in your installation, you may wish 
to ensure that all information logged by Domino is written to disk immediately. 
If this is the case, we recommend that you inactivate the lazy-writing option. 

Lazy-write (or write-behind) defers writing data to the disk until the operating 
system is idle or when the update is a maximum of five seconds old. This 
allows control to be returned to the application without having to wait for 
completion of I/O operations. 

The following is an example of an hpfs386.ini file: 

[filesystem] 
useallmem = Yes 
lanroot = C:\IBMLAN 
cachesize = 23808 

[lazywriter] 
lazy = * : ON 
maxage = 5000 
bufferidle = 500 
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[DASD_Limits] 

ThreshAlertNames = * : ADMINS 
ThreshAlertDelay = * : 10 
ThreshAlertUser = * : yes 
DirFullAlertNames = *: ADMINS 
DirFullAlertDelay = * : 10 
DirFullAlertUser = * : yes 

The [filesystem] section specifies general file system parameters: 

• useallmem = [yeslno] 

This parameter specifies whether the HPFS386 should use memory above 
the 16 MB boundary. Some adapters, for example, the IBM Token-Ring 
Busmaster Server/A, cannot do Direct Memory Access (DMA) to memory 
above the 16 MB boundary. If you have a LAN or disk adapter that cannot 
do DMA to memory above the 16 MB boundary, the HPFS386 must use 
only memory below 16 MB so that the adapter can put data into the file 
system buffers. Set useallmem to yes if all of your adapters can access 
memory above the 16 MB boundary. Set set allmem to no if any of your 
LAN or disk adapters cannot access memory above the 16 M boundary. If 
useallmem is not specified, the default setting is no. All the disk controllers 
and network adapter cards on the market today support memory access 
beyond the 16 MB limit. 

• cachesize = nnnn 

This parameter specifies how many kilobytes of memory the HPFS386 
should claim for its cache. The cache size must be a minimum of 256 KB. 
The maximum value is determined by the size of available memory. If 
cachesize is not specified, the default is to use 20 percent of available 
memory, if the amount of available memory is below 20 MB, or 60 percent 
of available memory, and if the amount of available memory is 20 MB or 
more. Available memory means the total system memory minus the 
memory spaces that are already used by device drivers and OS/2 before 
HPFS386 is started. 

• maxheap = nnnn 

This parameter sets a limit on the size of the heap, nnnn is the maximum 
number of kilobytes to which the heap can grow. The HPFS386 allocates 
heap memory as needed. If this parameter is used, the HPFS386 only 
allocates memory for the heap up to the amount specified. If this 
parameter is not used, there is no limit on the heap size. Use this 
parameter only if you need to reserve memory on the system for other 
applications that may be running. The minimum value is 64 KB. The 
maximum value is determined by the size of available memory minus the 
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size of the cache. If maxheap is not specified, the default is to have no 
limit on the heap size. 

• lanroot = drive:\path 

This parameter specifies the drive and path of the directory for the LAN 
Server software. The installation program fills in this parameter for you. 
You do not need to change this parameter. 

• fsprealloc = nn 

This parameter specifies how many big buffers to allocate when the file 
system is initialized. If neither fsprealloc nor srvprealloc are used, the file 
system allocates big buffers as needed. The allocation of big buffers can 
take a little time. Allocating the big buffers at initialization improves the 
performance of the first requests that need big buffers. The buffers are not 
freed until the system is shut down. The minimum value for fsprealloc is 2. 
The maximum is 64. If both fsprealloc and srvprealloc are specified in this 
file, fsprealloc is used and srvprealloc is ignored. 

• srvprealloc = nn 

This parameter specifies how many big buffers to allocate when the server 
is started, rather than when the file system is initialized. This parameter, 
like the fsprealloc parameter, can improve the performance of the first 
requests that need big buffers. The buffers are freed when the server is 
stopped. The minimum value for srvprealloc is 2. The maximum is 64. If 
both fsprealloc and srvprealloc are specified in this file, fsprealloc is used 
and srvprealloc is ignored. 

The [lazywriter] section specifies settings for the lazy-write function. You can 
use the CACHE386 program to change the internal setting of these 
parameters while the system is running. When you reboot the system, the 
parameters are set to the values in this file. The settings are as follows: 

• lazy = [drives:] ONIOFF 

This parameter specifies whether the lazy-write function is to be turned on 
or off for the specified drives. The [drives:] can be a series of drive letters. 
For example, lazy = cd: on would turn on the lazy-write function on drives 
c: and d:. An asterisk (*) can be used for the drive letter to indicate that all 
drives are to have the setting. This line can be used multiple times to 
achieve the settings you want for your drives. If lazy is not specified, the 
default value is to turn the lazy-write function off for all drives. 

• maxage = [drives:] nnnn 

This parameter specifies the maximum number of milliseconds that can 
pass before the lazy-write function writes the contents of a buffer to the 
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disk. The [drives:] can be a series of drive letters. For example, maxage = 
cd: 5000 would set the maximum buffer age to 5000 ms on drives c: and d:. 
An asterisk (*) can be used for the drive letter to indicate that all drives are 
to have the setting. This line can be used multiple times to achieve the 
settings you want for your drives. The minimum value is 0. The maximum 
value is 1 000000. If maxage is not specified, the default value is 1 0000 for 
all drives. 

• bufferidle = [drives:] nnnn 

This parameter specifies the maximum number of milliseconds during 
which a buffer is not used before the lazy-write function writes the buffer 
contents to the disk. The [drives:] can be a series of drive letters. For 
example, bufferidle = cd: 500 would set the buffer idle time to 500 ms on 
drives c: and d:. It would not change the settings for drive e: or h:. An 
asterisk (*) can be used for the drive letter to indicate that all drives are to 
have the setting. This line can be used multiple times to achieve the 
settings you want for your drives. The minimum value is 0. The maximum 
value is 500000. If bufferidle is not specified, the default value is 1000 for 
all drives. 

The [DASD_Limits] section specifies settings of parameters for the DASD 
Limits function: 

• ThreshAlertNames = [drives:] [userl] [user2] [groupl] [group2] 

This parameter lists the users or groups that are to be notified when a 
DASD Limits threshold is crossed on the specified drives. Any mixture of 
user names or group names can be used. All of the names must appear on 
one line. This line can be used multiple times to achieve the settings you 
want for your drives. If ThreshAlertNames is not specified, the default is to 
have no user or group names. 

• ThreshAlertDelay = [drives:] nn 

This parameter specifies how many minutes to wait before sending 
another alert for a threshold that was previously crossed on the specified 
drives. If a threshold is crossed more than once within the delay period, an 
alert is sent only for the first occurrence. An alert is sent if a higher 
threshold is crossed during the delay period. This parameter is used to cut 
down on the number of alerts that can be generated when there is a lot of 
disk activity and the disk size is within the threshold. This line can be used 
multiple times to achieve the settings you want for your drives. If 
ThreshAlertDelay is not specified, the default is 10 minutes on all drives. 

• ThreshAlertUser = [drives:] yeslno 
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This parameter specifies whether to send an alert to the user whose disk 
usage caused a threshold to be crossed on the specified drives. This line 
can be used multiple times to achieve the settings you want for your 
drives. If ThreshAlertUser is not specified, the default is yes for all drives. 

• DirFullAlertNames = [drives:] [userl] [user2] [user3] 

This parameter lists the users or groups that are to be notified when a 
DASD limit is reached. Any mixture of user names or group names can be 
used. All of the names must appear on one line. This line can be used 
multiple times to achieve the settings you want for your drives. If 
DirFullAlertNames is not specified, the default is to have no user or group 
names. 

• DirFullAlertDelay = [drives:] nn 

This parameter specifies how many minutes to wait before sending 
another alert for a DASD limit that was previously reached. If a DASD limit 
is reached more than once within the delay period, an alert is sent only for 
the first occurrence. This parameter is used to cut down on the number of 
alerts that can be generated when there is a lot of disk activity and the 
DASD limit is reached several times. This line can be used multiple times 
to achieve the settings you want for your drives. If DirFullAlertDelay is not 
specified, the default is 10 minutes on all drives. 

• DirFullAlertUser = [drives:] yeslno 

This parameter specifies whether to send an alert to the user whose 
request failed because a DASD limit was reached. This line can be used 
multiple times to achieve the settings you want for your drives. If 
DirFullAlertUser is not specified, the default is yes for all drives. 

2. 2. 3. 2 Journaled File System (JFS) 

The Journaled File System is an Installable File System (IFS) that was built 
on IBM AIX JFS technology. Flowever, the disk-image layout differs due to the 
feature set of the file system that is unique to OS/2 Warp Server for 
e-business. 

One of the shortcomings of FIPFS and HPFS386 is the amount of time 
required to recover from a system crash on large hard drives. JFS overcomes 
this by providing a robust, quickly-restartable, transaction-oriented, log-based 
high performance 32-bit file system for OS/2. It is primarily tailored for the 
high throughput and reliability requirements of modern servers, especially in 
the TCP/IP environment. 

The JFS provides the same range of supported file system operations for 
organizing and managing physical files, which was traditionally provided by 
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HPFS. However, in its first release, the JFS is not bootable. The JFS is 
created in a logical volume and can be expanded across disks to meet disk 
requirements. It supports both file and partition sizes up to 2 TB, and can 
recover within minutes from a system crash. The JFS has been enhanced for 
performance scalability on Symmetrical Multi Processor (SMP) systems and 
for TCP/IP transactions, making it ideal for Web and Domino data serving. 
Another feature of the JFS is its support for Sparse Files, making it ideal for 
large databases. Sparse files allow large database structures to be defined, 
but occupy only the amount of disk space that is consumed by the database; 
thus, a 2 TB file can be created on a 2 GB partition if there is less than 2 GB 
of actual data to be stored. 

The journaled file system is implemented through a set of operating system 
commands that allow creation, management, and deletion of files. Special 
32-bit extension has been added to optimize JFS performance. To support 
large cache size, the VIRTUALADDRESSLIMIT parameter must be reduced 
from the default 2048 to allow large caches (HPFS386 and JFS). When set to 
512, cache sizes up to 640 MB have been tested. 

JFS cache 

In most cases, applications requesting data that resides on JFS-formatted 
partitions will receive the data from the JFS cache. The JFS cache, like 
HFPS, FAT, and HPFS386 caches, is initialized on startup. The JFS cache is 
configured and initialized by the IFS statement in the config.sys. 

All buffer cache I/O is performed through explicit I/O requests to the 
underlying DASD device driver. The buffer cache resides in pinned memory 
and is shared by all mounted JFS file systems. 

By default, the size of the JFS buffer cache will be 12.5 percent of the size of 
physical memory. Not all file system I/O will be performed through the buffer 
cache since the JFS supports the NOCACHE advisory file open mode. When 
this function has been requested for a file, the JFS will perform I/O directly 
between user buffers and the underlying device when processing read and 
write operations on the file. 

To configure the JFS, an IFS= statement must be added to config.sys. This 
statement is described below: 

IFS=pathname [/CACHE:<size in meg>] [/AUTOCHECK:drive[drive...]] 
[/L:OFF I /L:synctime,maxage,bufferidle]] 

For example: 
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IFS=C: \0S2\JFS . IFS /AUTOCHECK:* /CACHE:1024 



Table 7. JFS initialization parameters 



Parameter 


Description 


pathname 


Specifies the pathname of the JFS IFS. 


/CACHE:<size in MB> 


Specifies the size of the JFS buffer cache in MB. 
By default, this size is set to 12.5 percent of the 
physical memory. 


/L:<synctime,maxage,bufferidle> 


Synctime is the interval at which the sync thread 
runs, default = 32. 

Maxage is the longest time that a frequently 
modified file is kept in cache, default = synctime *4. 
Bufferidle is the time indicating a recent change. 
Changes newer than this value are not written 
unless the last write was older than maxage, 
default = MIN (1 , synctime/8). 


/AUTOCHECK:drive[drive...] 


Specifies a list of JFS file systems, identified by 
driver letter, to be included in automatic recovery 
by CHKDSK at the time of JFS initialization. If an 
asterisk (*) is specified instead of a drive letter list, 
then all JFS file systems will be included in 
automatic recovery during JFS initialization. If any 
drive letter is preceded by an arithmetic plus sign 
(+), then CHKDSK will perform a full integrity 
check on the drive, even if journal log replay has 
restored the drive to an apparently consistent 
state. If the list of drive letters ends with 
plus-asterisk (+*), then CHKDSK will perform a full 
integrity check on all JFS file systems not specified 
in the list, even if journal log replay has restored 
them to an apparently consistent state. 



System limits 

The majority of the JFS size limits are imposed by the OS/2 kernel and 
system interfaces rather than the JFS itself. These limitations, both actual 
(OS/2 imposed) and potential (the JFS limit), are detailed below: 

• Buffer cache 

The size of the buffer cache is configurable and is limited by the amount of 
virtual memory that can be allocated to the kernel. If you need larger 
caches for FIPFS386 or JFS, you must reduce VIRTUALADDRESSLIMIT= 
from its default of 2048. When it is set to 512, cache sizes up to 640 MB 
have been tested. The JFS cache is designed to support a cache up to 2 
GB. 
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Note 



During OS/2 Warp Server for e-business installation, if a JFS partition is 
not found on the system, the installation program sets the JFS cache size 
to only 1024 KB. Later on, if the user creates a JFS partition, the cache 
size still remains at 1 MB. This 1 MB cache size is too small for optimum 
performance and results in significant performance degradation. Unless 
you increase the cache size in the config.sys file or, if you are required to, 
re-install the server operating system, the JFS cache size will remain at 1 
MB. 

To change the JFS default cache size from its default value, edit the 
JFS.IFS statement found in config.sys to read: 

DEVICE=C : \OS2\JFS . IFS /CACHE:xxxx / AUTOCHECK : D 

Where xxxx is the size in kilobytes and d : is the JFS volume. For example, 
depending on the applications run on the server, you can set the cache 
size to between 16 and 32 MB on a system with 128 MB of RAM installed. 



• File System Size 

The maximum file system size, imposed by the width of the device driver 
I/O request interface, is 2 TB. However, the JFS is designed to support 
files of 51 2 TB (with a block size of 51 2 bytes) to 4 Petabytes (with a block 
size of 4 KB). 

• File size 

The file size limit has been increased to 2 TB. This is imposed by the width 
of the file offsets and sizes beginning at the DOS APIs. The JFS file size is 
governed by the underlining file system. 

• Number of file system objects 

The maximum number of files and directories within a single JFS system 
is well over 4 billion. This limit is imposed by the JFS and is due to the size 
of the unique ID (inode number) used by the JFS to identify files and 
directories within a file system, since the JFS represents inodes as a 
standard unsigned 32-bit integer. 

• Extended attributes 

The extended attributes for any single file or directory is limited to 64 KB. 
This limit is imposed by the width of extended attribute sizes beginning at 
the DOS APIs. However, internally, JFS has a size equal to the amount of 
storage that can be represented through a single extent. The size of an 
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extent varies from 8 GB (with a block size of 512 bytes) to 64 GB (with a 
block size of 4 KB). 

HPFS386 features not available with JFS 

HPFS386 has for some time been the most significant file system available 
for OS/2. Many additional features have been developed over time based on 
HPFS386. Some of these features are not yet available for JFS. 

• DASD limits 

The current version of JFS shipped with OS/2 Warp Server for e-business 
does not support DASD limits. Depending on your requirements, there are 
several possible workarounds; two of them are: 

- Keep the resources that need directory limits on an HPFS386 
formatted volume. 

- Use CHKSTOFt as a replacement if it is sufficient to send an alert to the 
administrator when the limit is exceeded. 

• Fault tolerance (software RAID) 

There is no replacement for the HPFS386 fault tolerance feature in JFS. 
Current server hardware usually comes with RAID adapters that can be 
used to perform this function as a hardware solution. 

If you still need to rely on the software disk mirroring provided by 
HPFS386, you will have to run HPFS386. 



2.2.4 Comparison of features between file systems 

Table 8 summarizes the differences in features between FAT, HPFS, 
HPFS386, and JFS. 



Table 8. Feature comparison between FAT, HPFS, HPFS386, and JFS 





FAT 


HPFS 


HPFS386 


JFS 


Cache 


14.4 MB 


2 MB 1 


1 GB 2 


2 GB 2 



Notes: 

1 With the HPFS cache, the 2 MB limit is due to limits imposed by the 16-bit IFS architecture. 
2 Actual maximum size limited by system configuration, 200 - 700 MB typical. 

3 ACL is limited to 8192 for FAT, CD-ROMs, and HPFS, and this information is stored in the last half 
of net.acc. 

4 FAT imposes a limit on the root directory, which can be 1 12 or less. For hard disks, it generally has 
a value of 256 or 512 hardcoded in the boot sector. Although subdirectories are theoretically 
unlimited, performance can be seriously degraded if the number of files per directory is greater than 
the number of buffers (set in config.sys). 

5 Direct Access Storage Device. 
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FAT 


HPFS 


HPFS386 


JFS 


Max. no of file opens 


65536 


65536 


65536 


65536 


Max. no of file finds 


3072 


3072 


8192 


32768 


Max. file size 


2 GB 


2 GB 


2 GB 


2 TB 


Max. partition size 


2 GB 


64GB 


64GB 


2 TB 


ACL Support 


net.acc 


net.acc 


in Fnode 


in Inode 


ACL Limit 


81 92 3 


8192 3 


unlimited 


unlimited 


Max. no of connections 


16384 


16384 


16384 


16384 


Max. no of shares 


1500 


1500 


1500 


1500 


Max. no of file per directory 


51 2 4 on the 
root directory 


limited by 
DASD 5 space 


limited by 
DASD 5 space 


4 billion 


Bad block relocation 


No 


Yes 


Yes 


Yes using LVM 


Notes: 

1 With the HPFS cache, the 2 MB limit is due to limits imposed by the 16-bit IFS architecture. 
2 Actual maximum size limited by system configuration, 200 - 700 MB typical. 

3 ACL is limited to 8192 for FAT, CD-ROMs, and HPFS, and this information is stored in the last half 
of net.acc. 

4 FAT imposes a limit on the root directory, which can be 1 12 or less. For hard disks, it generally has 
a value of 256 or 512 hardcoded in the boot sector. Although subdirectories are theoretically 
unlimited, performance can be seriously degraded if the number of files per directory is greater than 
the number of buffers (set in config.sys). 

5 Direct Access Storage Device. 



2. 2. 4.1 Logical Volume Manager 

Even with the rapid advances in Direct Access Storage Device (DASD), 
modern hard disk capacity still has not managed to satisfy corporate 
demands, such as dynamically increasing DASD storage and spanning 
across physical disks. As a result, a new solution was needed to simplify 
DASD management within OS/2. An integral part of the solution is the 
introduction of the Logical Volume Manager (LVM) in OS/2 Warp Server for 
e-business replacing FDISK. 

LVM provides an abstraction layer for the file system, in that it makes 
transparent to both applications and users the logical/physical makeup of the 
volume. LVM (lvm.exe) exploits new features of the underlying logical volume 
management system, thus allowing flexible division, allocation, and 
management of the system disks. It provides all the function of FDISK and 
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additional features, such as disk spanning, dynamic resizing, and sticky drive 
letters. 

The objective of LVM is to provide a logical layer for the support of logical 
volumes for the OS/2 DASD I/O subsystem. With the introduction of LVM 
support, a partition is no longer restricted to logical partitions wholly 
contained on physical drives. Disk spanning is now allowing dynamic partition 
resizing for JFS volumes. 

LVM vs. Compatibility volumes 

Only LVM volumes can be expanded. Compatibility volumes that are 
formatted with the FAT or FIPFS file system cannot be expanded. 



In order to implement the LVM functionality, some existing OS/2 components 
have been modified and a number of new components added. The 
performance and SMP scalability has been improved by converting parts of 
the existing kernel execution environment from 16-bit to 32-bit. This new 
kernel execution environment is used by JFS, LVM, OS2DASD, and TCP/IP. 

2. 2. 4. 2 Performance considerations 

As already mentioned, the JFS code has been highly optimized for the 32-bit 
environment. Additional 32-bit code has been included in the OS/2 kernel for 
JFS to gain performance from the flat 32-bit memory address space. The 
32-bit implementation also allows JFS to scale better in SMP environments. 

Additional APIs have been added to the instruction set to allow TCP/IP 
applications, such as Domino, to have gains in performance. This results from 
the direct access some TCP/IP instructions have to data stored in the JFS 
cache. Preliminary tests have shown that JFS serving local applications (thus 
acting as an application server) outperforms HPFS386 by almost doubling 
performance. When used to serve Domino to a large number of users, it was 
shown that the response time of JFS was quicker than the Windows NT 
NTFS. 

Unfortunately, JFS performance as a file and print server is not as easy to 
compare with HPFS386. First, when any performance comparisons between 
HPFS386 and JFS are made, networking consideration need to be 
eliminated. The network bottleneck will impede server performance long 
before the file system will; therefore, a fast network is recommended. In fast 
networks, it is the hardware configuration of the server that is going to govern 
the choice of file systems. If the server is only a uniprocessor, JFS can have 
up to a 40 percent degradation over HPFS386. 
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The reason for the difference in file serving throughput between JFS and 
HPFS386 is increased path length for JFS due to the additional ring 
transitions it must do. These extra ring transitions require extra CPU cycles. 

JFS scales better in an SMP environment. Therefore, at 4-way throughput 
between FIPFS386 and JFS, it has been shown to be similar, with HPFS386 
only slightly better. Flowever, in 5-way or better, JFS is expected to excel. If 
the server CPU is under utilized, less than 50 percent free most of the time, 
JFS performance could be equivalent to HPFS386 in 4-way or less scenarios 
since the CPU will have enough time to process the ring transitions. 

Another point that may need to be considered is whether the hardware 
configuration provides fault tolerance. If not, HPFS386 is still a better option 
since it provides software RAID-1 (both mirroring and duplexing) fault 
tolerance. This may be a consideration in small server installations. 

No software fault tolerance with JFS 

If disk fault tolerance is required, it is recommended to use hardware-based 
solutions instead of software-based solutions. Hardware RAID solutions 
typically provide better performance, better reliability and easier 
maintenance. 



2.2.5 Deciding on fault tolerance 

A Domino server tends to be disk l/O-intensive. Therefore, you should not 
underestimate the importance of the disk subsystem. The first guideline is 
that you only use disk controllers designed for server environments. And, if 
possible, select a SCSI RAID adapter instead of regular SCSI adapters. 
Redundant Array of Inexpensive Disks (RAID) typically provides both better 
performance and high availability. 

On IBM server platforms, the new ServeRAID-3L or 3H adapters are excellent 
choices. Both adapters support RAID levels 0, 1, 1 enhanced, and 5, and 
both adapters also come with 4 MB of cache or more. 

You can improve the disk I/O throughput by spreading the workload across 
several physical hard disks. For example, you could install the operating 
system and the Domino server executables on the first physical disk and all 
the Domino databases on the other hard disks as shown in Figure 4. 



Preparing for installation 49 





SCSI 



OS/2 System Domino Database 

swapper.dat 

Domino Code 



Figure 4. A non-RAID disk configuration 

The swapper file swapper.dat should reside on the same physical drive as the 
operating system. The operating system and Domino server typically cause 
very little hard disk activity. Domino databases (or mail files) are typically very 
disk intensive, and therefore, it is recommended to dedicate one or more 
physical disks. 

If you want to further improve disk I/O, you can add one extra physical hard 
disk and enable Domino transaction logging. For instructions to enable 
transaction logging, see 5.3.6, “Transactional logging” on page 160. You 
should never place the transaction log and the Domino databases on the 
same physical disk device. 

If more disk storage space is required for the databases, you can distribute 
the workload on multiple hard disks by using Domino Directory links. 

If better performance is required, a RAID disk subsystem is required. RAID 
stands for Redundant Array of Inexpensive Disks and means that two or more 
physical disks are grouped together and they appear to the operating system 
as one (or more) physical disk. All the disks in the RAID array should be the 
same size. 
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The RAID standard specifies several RAID levels, but IBM SCSI-based disk 
controllers support only the most used levels, which are RAID-0, RAID-1, 
RAID-1+, and RAID-5. 

Note 

The IBM RAID controller cache write policy should be changed from write 
through to write back. The controller should have optioned battery backup. 



RAID-0 typically provides the best performance. In RAID-0 configurations, 
two or more disks are grouped together and the data is spanned evenly on all 
the disks. RAID-0 does not give any fault tolerance: If one of the disks fail, the 
whole disk group (or disk array) fails. 

RAID-1 is disk mirroring and always requires two hard disks. The same data 
is always written to both the disks and, therefore, this RAID level recovers if 
one of the disks fail. RAID-1 performance is a bit worse than RAD-0, but 
because of its high fault tolerance, it is very widely used. The drawback is that 
RAID-1 wastes 50 percent of all the purchased hard disk space. 

RAID-1+ is RAID-1 with several enhancements. RAID-1+ supports two or 
more hard disks in the array, but the data and mirrors are striped on the disks. 
RAID-1+ gives great performance and great fault tolerance. The cost of 
RAID-1 if 50 percent of the total disk space. In other words, if you purchase 
four 18.2 GB hard disks and configure them as RAID-1+, the overall disk 
capacity will be 36.4 GB. 

RAID-5 is also referred to as disk striping with parity. RAID-5 requires more 
processing, because each time data is written, the checksum data is being 
calculated and stored in the array. RAID-5 read performance is very good, but 
write performance is worse than in RAID levels 1 or 0. RAID-5 disk 
configuration requires at least three physical hard disks. RAID-5 is cheaper to 
implement than RAID-1, because the checksum data requires only the disk 
space of one of the disks in the array. Note that the checksum is not stored on 
one disk, but is spread among the disks. 

If you want to optimize the disk subsystem by using the RAID SCSI controller, 
one good configuration is shown in Figure 5 on page 52. As a rule of thumb, 
four to six data drives per processor is balanced system. An array of up to 1 6 
drives on 4-way SMP is useful. For example, Netfinity 7000 (4 x 400 MHz 
CPU) can use up to 20 drives. 
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Figure 5. RAID system sample disk configuration 



In this example, we have three RAID arrays configured: one for the operating 
system, paging file, and Domino executables, one for Domino databases, and 
one for transaction logging. 

The number of disks required in the Domino database array to achieve 
maximum performance and capacity may often be more than is needed to 
satisfy the OS storage requirements. 

If you require the best performance and reliability, you should configure your 
RAID subsystem to run RAID-1 . RAID-0 is proven to be the fastest RAID 
level, but because there is no high availability whatsoever, it is not a good 
solution for Domino platforms. 
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You can also consider installing more than one RAID or SCSI adapters and 
distributing the databases, and the disk workload, across several SCSI 
channels and disk devices. For more information on this and many other disk 
configuration issues, refer to the IBM redbook Netfinity and Domino R5.0 
Integration Guide, SG24-5313. 

Recommendation 

If best performance and high availability is required, we recommend 
configuring your Domino server to run on RAID-1 systems. You can also 
install several RAID adapters to distribute the workload on several SCSI 
channels. 



On IBM Netfinity servers, Netfinity Manager is the best tool to gather 
information on RAID utilization. 

2. 2. 5.1 Database distribution 

RAID-1 is the best solution for the fastest disk I/O. For non-RAID systems, 
distributing the Domino databases across multiple physical disk devices can 
improve performance in highly stressed server environments. In practice, this 
means that instead of placing all the Domino databases on the same disk 
device, you create directory links to another disk device and place some of 
the databases on this device. 

A directory (or database) link must be used, because all the databases 
should appear under the same Domino data directory. Using a directory link, 
you can make a directory on another disk device to appear under the Notes 
data directory. This technique is especially useful for mail servers and 
clustered servers. The Netfinity and Domino R5.0 Integration Guide , 
SG24-5313 details this technique. 

2.2.6 Domino network design tuning considerations 

In this section, we discuss some Domino network design issues that may 
affect the server and your whole Domino environment performance. The 
following topics are discussed here: 

• Network subsystem considerations 

• Network protocol selection 

• Domino server role in the domain 

• Replication topology 

• Domino clustering considerations 
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Hint 



For much more detailed information on Domino network and server design 
issues, refer to the IBM redbook Netfinity and Domino R5.0 Integration 
Guide, SG24-5313. You will find guidelines, for example, for Domino server 
naming conventions, network capacity planning, and many other issues. 



2. 2. 6.1 Network subsystem 

Optimizing the networking subsystem can be divided into two parts: the 
overall network design and the network adapter configuration on the server. 
The overall network design refers to how your actual network is designed, for 
example, whether the network is switched or not, how the routing is 
implemented, what protocols are supported, and so on. For example, it might 
be a good idea to connect all the main Domino servers directly to the switch 
and use full-duplex network traffic. Because network design optimization can 
be a very complicated issue, we are not going to go into any more depth here. 

Network adapter configuration is something that can be changed relatively 
easily. One of the most commonly used performance tuning options is to 
install one or more extra network adapters to get wider network bandwidth. 
OS/2 supports up to 32 network adapter interfaces (up to four if you use GUI). 
You should use PCI adapter cards only in the server. 

We also recommend that you run the TCP/IP protocol only, if possible. As 
mentioned earlier, Domino server supports a wide set of protocols, but some 
of the Domino features are specially optimized for TCP/IP, for example, 
Domino clustering. 

2. 2. 6. 2 Network protocol 

We recommend using TCP/IP as the primary networking protocol for Domino 
R5. Domino supports a number of protocols, including TCP/IP, SPX/IPX, and 
NetBEUI/NetBIOS. Network protocols, such as NetBIOS, may impose limits 
on the number of connections your server can support. Using TCP/IP, the 
number of connections is limited only by the server capacity to process the 
network traffic. Using TCP/IP also gives you considerable freedom in your 
choice of client platforms, since you can use the HTTP server capabilities 
built into Domino to allow client access using Web browsers, as well as 
regular Lotus Notes Clients. 

This release of Domino has been optimized for TCP/IP. TCP/IP has some 
other advantages. For example, the protocol is routable, which means it can 
be run natively on WAN over routers. 
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Recommendation 



Use TCP/IP as the preferred protocol for Domino R5. 



For more information, see 2.2.1, “Running Lotus Domino R5 on TCP/IP” on 
page 28. 

2. 2. 6. 3 Domino server roles 

In a file/print server environment, you probably want to dedicate one or more 
servers for printing only, some servers for serving home directories, some 
servers for application program files, and so on. Dedicating one server to do 
just one thing makes administration easier, and even more importantly, allows 
the server to do just one thing and do it at its full capacity. Requirements for a 
print server, for example, are very different from a file server. Typically the file 
server gains an advantage from a huge disk cache, while a print server hardly 
ever gets any performance advantage from the disk cache. 

This discussion applies to Domino server roles as well. To make one server a 
mail server, database server, Web server, remote connection server, and a 
directory catalog server may be a good solution in a small environment, but if 
you are planning hundreds or thousands or more users, this is not an ideal 
solution. 

There is more than one way to categorize Domino servers by role, but the one 
we have found most useful is the one shown below: 

• Mail server 

• Database (or application) server 

• Hub server 

• Domain catalog server 

• Extended search server 

You can add other server roles, for example, directory server, which runs the 
Directory Cataloger and LDAP tasks and holds the Directory Catalog and 
Directory Assistance databases. 

One example of Domino server roles and network design is shown in Figure 6 
on page 56. 
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Notes Domain 3 — 




connection ^ w mail transfer or 

between servers ^ ^ database replication 



Figure 6. An example of server roles and Domino network design 

In this example, the Domino environment consists of three Notes domains 
connected to each other with slower WAN links. To minimize the traffic across 
the slow links, each branch has at least one Domino server. The hub server is 
configured to execute the mail routing and database replication between the 
domains. The users in each domain access only their local Domino servers. 
The branch office Domino servers hold only replica copies of those database 
that are actually used on an everyday basis. 

In conclusion, server roles are used to optimize a server to run fewer tasks 
with better performance. Domino network design and server roles are very 
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closely connected. Server roles and replication topology are very important 
issues when optimizing network traffic over WAN links. Additional information 
on server roles can be found in 5.4.1, “Server roles” on page 1 65. 

2. 2. 6. 4 Replication topology 

By designing the replication topology and scheduling properly, you can affect 
server performance quite a lot. The first question is: Do you want to 
implement a hub-spoke network or replicate directly between the required 
servers? You may also need to consider which of the replicating server pairs 
run the replicator task, or both. And finally, what is the schedule for 
replication? A faster replication cycle keeps the databases more tightly in 
sync, but on the other hand, creates more network and server workload. 
Looser replication, in turn, takes less resources, but may compromise the 
data integrity. 

There is no simple answer to replication questions because requirements 
vary greatly from one environment to another. You may want to consider 
hiring an IBM or Lotus specialist to help you with network design and 
optimization. 

2. 2. 6. 5 Domino clustering 

Although Domino clustering is a solution for high availability, it can be used for 
performance utilization as well. In short, a Domino cluster means that 
between two to six Domino servers in the same Notes domain are logically 
grouped together to act as a cluster. Domino clustering is based on the fact 
that a database on a clustered server is replicated to one or more nodes in 
the same cluster. The data in the database is kept in sync by a special server 
task, cluster replicator, that runs on each clustered server. Cluster replication 
is event driven, so every time a database is being updated, the change is 
replicated to all the other replicas. Because this design is not realtime, there 
can be some delays before the changed data is replicated to other database 
copies. However, this delay time is typically seconds or tens of seconds. 

When a user connects to a clustered server for the first time, it receives 
information on all the members in the cluster. When a user tries to connect to 
a database that is not available on the server, or the requested server is not 
responding, the database will be opened seamlessly from another server in 
the cluster holding a replica copy of the database. This is called fail-over. 

In Domino R4, clustering fail-over was only available for Notes Clients. But in 
Release 5, Domino ships with the Internet Cluster Manager (ICM) that 
redirects the Web client requests inside the cluster. 
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The performance advantage is based on the fact that there are more servers 
serving the clients. The clustering itself creates a performance degradation 
on the server because of the cluster replicator task. Clustering also requires 
some extra processing power and hard disk space. For these reasons, two 
servers in a cluster do not mean twice the capacity. 

Even though setting up a cluster means extra planning and more hardware 
investments, you would be getting a very high availability environment with 
great expandability and better overall performance. 

You can find more information on Domino clustering on Windows NT in the 
IBM publications Netfinity and Domino R5.0 Integration Guide, SG24-5313, 
and High Availability and Scalability with Domino Clustering and Partitioning 
on Windows NT, SG24-5141 . Most of the issues covered apply to the OS/2 
platform as well. 
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Chapter 3. Installing a new Domino server 



Domino R5 server installation and configuration tasks are easy and straight- 
forward. New Notes Clients for server administration that were included in 
previous releases are no longer provided. Instead, a Web browser is required 
to configure the server after basic installation completes. 

Before installation, Domino network planning is required, for example, the 
Domino server hierarchical structure, each server’s role, certification 
structure, MPTS configuration, and LAN Server/Requester configuration 
should be planned if you use NetBIOS protocol. For planning tasks, refer to 
following publications: 

• Domino Release 5, Administering the Domino System Volume 1 
(CT6T7NA) and Volume 2 (CT6T8NA) 

• Lotus Notes and Domino R5.0 Security Infrastructure Revealed, 
SG24-5341 

• Netfinity and Domino R5.0 Integration Guide, SG24-5313 



3.1 New installation of Lotus Domino R5 

This section describes how to install Lotus Domino R5 on OS/2 Warp Server. 
Migration issues are discussed in Chapter 4, “Migrating from Domino R4.5 
and R4.6” on page 83. 

Make sure that hardware and software requirements, as illustrated in Chapter 
2, “Preparing for installation” on page 25, have been met. 

3.1.1 Installing Lotus Domino R5 

Installation of Domino R5 is composed of two phases, file copy and 
configuration. To begin the first phase, perform the following steps. 

1. Open an OS/2 window. 

2. Change to the drive and directory where the Lotus Domino R5 for OS/2 
product image resides. 

3. To start the installation process, execute: instpm 
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4. The dialog box shown in Figure 7 appears. 



Installation Method 



Lotus Domino for OS/2 
Select one of the following: 

Domino Application Server 

Select this option to install a standard Domino 
Server to provide mail and application services. 

Domino Mail Server 

Select this option to install a Domino Server 
to provide mail services only. 

• Domino Enterprise Server 
Select this option to install a Domino Server 
that includes Domino clusters. 



OK 



Exit Install Help 



Figure 7. INSTPM: Installation method dialog panel 



5. Select the option that corresponds to your license agreement, then click 

OK. 

These are the license options: 

- Domino Application Server for the Domino Application Server license 

- Domino Mail Server for the Domino Mail Server license 

- Domino Enterprise Server for the Domino Enterprise Server license 

6. When the Lotus Notes Installation and Instructions dialog panel appears, 
click Continue. 

7. When the Install dialog displays, check Update CONFIG.SYS, then click 

OK. 
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8. Select the components to be installed from the Install - directories dialog 
shown in Figure 8. If you are uncertain what components to install, click 

Select all. 




Figure 8. INSTPM: Install - directories dialog panel 

If you want to change the Notes directory and Notes Data directory, modify 
them accordingly then click Install.... 

Note 

The server certification ID (CERT.ID) file that is created during the 
configuration phase will be placed in the Notes Data directory. This is 
also known as the Domino Directory. 

An installation progress indicator is displayed. After all files have been 
transferred successfully, you will be asked to reboot so that changes take 
effect. Click OK, then the installation program completes. 

9. Shutdown and reboot the system. 

3.1.2 Java environment considerations 

Domino R5 for OS/2 includes a Java environment that should be used if you 
plan to support servlets through Domino’s HTTP server. During the Domino 
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R5 installation, the Java environment component can be selected and will be 
installed automatically if you chose the Select all button shown in Figure 8 on 
page 61 . 

Java LIBPATH and PATH Considerations 

The Domino R5 install program places its directories in front of the first 
directory entry of LIBPATH and PATH. You may need to change the 
directories order if your server has a system JVM installed also. As a 
general recommendation, always haveVJAVAII directories placed before 
any DOMINO entries. 



3.2 Configuring Domino R5 

In previous releases of Domino, configuration tasks could be performed from 
the Notes Administration client. Domino R5 server requires configuration from 
a Web browser after the installation. The Web browser must be JavaScript 
enabled. 

Note 

Before proceeding, we recommend making a backup copy of the 
setupweb.nsf file. This file keeps configuration information during 
configuration tasks described in later sections and will be deleted when you 
finish the configuration task. 

If you have a backup copy of the original setupweb.nsf file, you can easily 
reconfigure the server without reinstallation process. 

A setupweb.nsf file is located in the Notes data directory on the server. 



3.2.1 Starting the HTTP server for configuration 

To start configuration task, you have to start the HTTP server as shown 
below: 

1 . Click the Lotus Domino Server icon in the Lotus Applications folder or start 
an OS/2 window and change to a Domino data directory (default is 
c:\domino\data) and issue following command: 

[d:\DOMINO\DATA] ihttp httpsetup 
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